
<HTML>
 <HEAD>
  <TITLE> API document </TITLE>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <link rel="stylesheet" href="../css/zTreeStyle/zTreeStyle.css" type="text/css">
  <style>
	body {
	background-color: white;
	margin:0; padding:0;
	text-align: center;
	}
	div, p, table, th, td {
		list-style:none;
		margin:0; padding:0;
		color:#333; font-size:12px;
		font-family:dotum, Verdana, Arial, Helvetica, AppleGothic, sans-serif;
	}
	.ztree li a.curSelectedNode {
		padding-top: 0px;
		background-color: #FFE6B0;
		color: black;
		height: 16px;
		border: 1px #FFB951 solid;
		opacity: 0.8;
	}
  </style>
<script type="text/javascript" src="../js/jquery-1.4.4.min.js"></script>
<script type="text/javascript" src="../js/jquery.ztree.core-3.5.js"></script>
<script type="text/javascript" src="../src/ztree_toc.js"></script>
	<SCRIPT type="text/javascript" >
	<!--
	$(document).ready(function(){
		$('#tree').ztree_toc({
			is_auto_number: true,
			// documment_selector: '.first_part'
		});
	});
	//-->
	</SCRIPT>

 </HEAD>

<BODY>
<TABLE border=0 height=600px align=left>
	<TR>
		<TD width=260px align=left valign=top style="BORDER-RIGHT: #999999 1px dashed">
			<ul id="tree" class="ztree">
				
			</ul>
		</TD>
		<TD width=770px align=left valign=top>

<h1>说明</h1>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:18px'>
	<strong>返回说明：</strong>

		status:1-返回正常 0-出现未知错误 -1-出现异常(已知错误)
		msg:当status为0时出现，内容是错误的编码，前端直接中断用户操作，在页面打印错误编码
		expand：数组形式，存在info、type,total等拓展字段。
				info 在status为-1时出现，是异常信息，前端可显示给用户看，
				type是异常信息的类型，没有登录或字段错误等，total一般是总条数
		data:返回的数据
		
		例如：
		{
			"status":1,  //实名成功
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
					"info":"请先登录",
					"type":1  //1-用户没有登录 2-没有输入真实姓名 3-没有输入身份证号 
					            4-没有正面照 5-没有背面照  6-没有同意协议 7-认证失败
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>


<h1>土特产</h1>

<h2>身份证认证信息页</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<!-- <h3>身份证认证信息页</h3> -->
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/AutIDcard
	<strong>传递参数：</strong>
		{
			"phpsid":'22222222',//session_id
			"is_check":1,//1-用户勾选同意
			"identity_card":'441881199502143312',//身份证号
			"real_name":'周斯航',//真实名字
			"card_face":'/Uploads/Picture/2017-12-28/5a444bd07ff94.jpg',//身份证头像面的图片链接
			"card_back":'/Uploads/Picture/2017-12-28/5a444bd07ff94.jpg',//身份证国徽面的图片链接
		}
		
	<strong>返回值：</strong>
		{
			"status":1,  //实名成功
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
					"info":"请先登录",
					"type":1  //1-用户没有登录 2-没有输入真实姓名 3-没有输入身份证号 
					            4-没有正面照 5-没有背面照  6-没有同意协议 7-认证失败
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<h2>地址管理</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>初始化获取令牌</h3>
	<strong>调用请求：</strong>http://www.ttc.com/ttc.php/Public/TokenInit
	<strong>传递参数：</strong>
		{
			"phpsid":'fdhjkalkla' //session_id(登录后的session_id)
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":"4enInbQk" //令牌号
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}

	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>默认联系人</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/DefaultContact
	<strong>传递参数：</strong>
		{
			"phpsid":'222222222',//session_id
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":{
					"id":"11",  //地址id
					"contact_name":"信6666666",  //联系人
					"contact_phone":"13345678910",  //联系电话
					"contact_wechat":"weixinhao",  //微信
					"prov":"北京",//省
					"city":"密云区",//市
					"area":"城区",//区
					"detailed_address":"北京北京"  //详细地址
					}
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>地址列表</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/ContactLists
	<strong>传递参数：</strong>
		{
			"phpsid":'222222222',//session_id
			"page":1,//第几页 后台默认一页条数是10条
		}
		
	<strong>返回值：</strong>
		{
		"status":1,
		"expand":{"total":"10"},//总条数
		"data":[
					{
					"id":"11", //地址id
					"is_default":"1", //1-默认地址 0-非默认地址
					"contact_name":"信6666666",  //联系人
					"contact_phone":"13345678910",  //联系电话
					"contact_wechat":"weixinhao",  //微信
					"prov":"北京",
					"city":"密云区",
					"area":"城区",
					"detailed_address":"北京北京"  //详细地址
					}
			   ]
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>增加/编辑地址</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/UpdateContact
	<strong>传递参数：</strong>
		{
			"phpsid":'222222222',   //session_id
			"contact_name":'周斯航',  //联系人
			"contact_phone":'18835676543',  //联系电话
			"contact_wechat":'222222222',  //微信
			"areaid_1":'广东',  //一级地区
			"areaid_2":'广州',  //二级地区
			"areaid_3":'海珠区',  //三级地区
			"longitude":'22',  //经度
			"latitude":'22', //纬度
			"detailed_address":'中洲中心', //详细地址
			"token":'173788dd', //令牌

			//修改地址时才需要传这个变量
			"contact_id":'2',  //地址id
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"expand":{"token":'gsisioawi733'},//新的令牌
			"data":"23"  //地址id 新增的时候才有 编辑时候返回null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
						"info":"请先登录",
						"type":1  //1-没有登录 2-字段错误 3-已经满20条，不能再添加 4-请求太快
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>设置默认联系人</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/setDefaultContact
	<strong>传递参数：</strong>
		{
			"phpsid":'222222222',   //session_id
			"contact_id":'2',  //地址id
		}
		
	<strong>返回值：</strong>
		{
			"status":1, //成功
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>


<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>删除地址</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/User/DeleteContact
	<strong>传递参数：</strong>
		{
			"phpsid":'222222222',   //session_id
			"contact_id":'2',  //地址id
		}
		
	<strong>返回值：</strong>
		{
			"status":1, //成功
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<h2>转发</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>增加转发量</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Goods/GoodsForward
	<strong>传递参数：</strong>
		{
			"phpsid":'22222222',//session_id
			"goods_id":1,//商品id
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<h2>投诉管理</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>保存投诉</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Goods/GoodsComplaint
	<strong>传递参数：</strong>
		{
			"phpsid":'22222222',//session_id
			"goods_id":1,//商品id
			"content":1,//投诉内容
			"imgs_id":1,//图片id
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>


<h2>图片上传</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>图片上传</h3>
	<strong>调用请求：</strong>http://www.ttc.com/ttc.php/Upload/UploadImages
	<strong>传递参数：</strong>
		{
			"file":$_FILES,//上传的图片文件
		}

	<strong>返回值：</strong>
		{
			"status":1,  //1-成功 0-失败
			"info":"上传成功",
			"data":"",
			"img_id":"138",
			"path":"http:\/\/www.ttc.com\/Uploads\/Picture\/2017-12-21\/5a3b5fbb8545b.jpg"
		}
		
	</pre>
</div>


<h2>发布土特产</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<!-- <h3>发布土特产</h3> -->
	<strong>调用请求：</strong>http://www.ttc.com/ttc.php/Goods/addGoods
	<strong>传递参数：</strong>
		{
			"phpsid":'2222222',//session_id
			"goods_validity":3,//发布有效日期
			"goods_name":"土特产名称",//土特产名称
			"goods_price":"30/箱",//土特产价格
			"goods_deliver":1, //0-快递，1-自提
			"goods_type":1,//0-现货，1-预定
			"goods_desc":"符合鸡的天性，保证鸡的身心健康。",//产品描述
			"contact_id":3,//联系id
			"images_id":'1,2,3',//图片id
			"goods_add_place":"广东 广州 海珠区 中洲中心",//发布地址（当前位置）
			"long":'14',//经度
			"lat":'334',//纬度
			"token":'334',//令牌 (初始化获取令牌在地址管理里面找接口)
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"expand":{"token":'gsisioawi733'},//新的令牌
			"data":"100530"  //商品id
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
						"info":"请先登录",
						"type":1  //1-请先登录 2-请求太快
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误

	</pre>
</div>


<h2>土特产详情</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>土特产详情</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Goods/GoodsInfo
	<strong>传递参数：</strong>
		{
			"id":1,//商品id
		}
		
	<strong>返回值：</strong>
		{
		"status":1,
		"data":{
					"id":"100511", //商品id
					"member_id":"104",
					"goods_name":"产品11", //商品名称
					"goods_price":"10元\/ 件",  //商品价格
					"goods_desc":"描述",  //商品详情
					"goods_storage":"0",
					"storage_unit":"0",
					"goods_add_time":"2017-12-25", //开始时间
					"goods_expire_time":"2017-12-28", //结束时间
					"goods_add_place":"广东 广州 海珠区 中洲中心", //发布地址
					"goods_click":"0",  //联系次数
					"goods_deliver":"1,2",
					"goods_type":"1,2",
					"images_id":"155,154",
					"contact_id":"1",
					"forward_amount":"3", //转发次数
					"goods_deliver_desc":"快递\/自提",  //发货方式
					"goods_type_desc":"现货\/预定",  //产品类型
					"pro_lt":{ //产品地址经纬度
								"longitude":null, //经度
								"latitude":null //纬度
							 },
					"add_lt":{ //发布地址经纬度
								"longitude":"", //经度
								"latitude":"" //纬度
							},
					"pro_addr":"广东 广州 海珠区 中洲中心",  //产品地址
					"contact_name":"hhh", //联系人名
					"goods_img":[
									{
									"id":"155",
									"path":"http:\/\/www.ttc.com\/Uploads\/Picture\/2017-12-23\/5a3db7358ccfb.png"
									},
									{
									"id":"154",
									"path":"http:\/\/www.ttc.com\/Uploads\/Picture\/2017-12-23\/5a3db731bdb56.png"
									}
								],
					"sid":"bqodcvt6gbl9k700ql2afqifr4" //session_id
			   }
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"商品不存在"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>
<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>马上联系  联系人</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Goods/GoodsContacts
	<strong>传递参数：</strong>
		{
			"goods_id":1,//商品id
			"phpsid":'444444',//当前操作用户session_id
			"sid":'444444',//当前商品的商家session_id
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":{
					"contact_name":"信",
					"contact_phone":"13345678910",
					"contact_wechat":"weixinhao"
					}
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"请先登录"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<h2>土特产列表</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<!-- <h3>土特产列表</h3> -->
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Goods/GoodsLists
	<strong>传递参数：</strong>
		{
			"page":1,//第1页
			"phpsid":'222222222',//session_id
			"lati":1,//当前位置纬度
			"long":1,//当前位置经度
			"share":1,//1-分享进来的 0-本商家查看
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"expand":{
						"all_page":1,//总页数
						"store_name":"店小二"//店铺名称
					},
			"data":[
					{
						"id":"100530", //商品id
						"goods_name":"hhh",  //商品名称
						"goods_price":"3",  //商品价格
						"images_id":"33",
						"contact_id":"1", 
						"distance":"13657.1km",  //距离
						"is_examine":"0",//0-发布成功 1-审核成功 2-审核失败 3-未审核
						"img":{
								"path":"http:\/\/www.ttc.com"
							  }
						"addr":"广州" //二级地区
					}
				  ]
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
						"info":"请先登录",
						"type":1 //1-没有登录 2-商家不存在(这种错误出现在从分享链接进来的，而且session_id错误的)
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<h2>文字验证码</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>获取session_id</h3>
	<strong>调用请求：</strong>http://www.ttc.com/cart.php/Public/verifyInit
	<strong>传递参数：</strong>
			无
		
	<strong>返回值：</strong>

		{
			"status":1, //成功
			"data":"gb3ad25lu6gn1o9jp33ao9tm76" //session_id
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上2种，前端可报网络错误

	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>文字验证码</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/verify/sid/上面接口返回的session_id

	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>验证文字验证码</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/check_verify
	<strong>传递参数：</strong>
			{
				"phpsid":'ffffffffff',//session_id
				"code":'1884',//用户输入的文字验证码
			}
		
	<strong>返回值：</strong>

		{
			"status":1,
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{"info":"验证码错误"},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误

	</pre>
</div>

<h2>短信验证码</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<!-- <h3>短信验证码</h3> -->
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/sendCaptcha
	<strong>传递参数：</strong>
		{
			"phone":'18825674456',//手机号
		}
		
	<strong>返回值：</strong>
		{
			"status":1,//发送成功状态
			"data":null
		}
		{
			"status":-1, //发送异常
			"expand":{"info":"同一手机号60秒内，请勿多次获取验证码！"}, //异常错误
			"data":null
		}
	</pre>
</div>

<h2>用户操作</h2>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>用户登录&&注册</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/login
	<strong>传递参数：</strong>
		{
			"mobile":'18826072233',//手机号
			"verify":'123',//文字验证码
			"msm_verify":'1345',//短信验证码
			"phpsid":'rssjskskskl',//获取验证码返回的session_id，用于提交后检验验证码
		}
		
	<strong>返回值：</strong>
		{
			"status":1,
			"data":"iouj4df1mlmf4mtc7oisog74g0" //返回session_id
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
						"info":"验证码错误",
						"type":1 //1-图文验证码出错 2-手机出错 3-短信验证码出错
					},
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>用户是否登录</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/is_login
	<strong>传递参数：</strong>
		{
			"phpsid":'2fghuuei834849',//phpsessionid
		}
		
	<strong>返回值：</strong>
		{
			"status":1, //已经登录了
			"expand":{
						"has_goods":0 //0-没有发布过商品 1-已经发布过商品
					 },
			"data":null
		}
		{
			"status":-1,  //没有登录
			"expand":{"info":"请先登录"},
			"data":null
		}
	</pre>
</div>

<div style='margin-bottom:20px;'>
	<pre style='background:#C7EDCC;font-size:12px'>
	<h3>用户是否实名</h3>
	<strong>调用请求：</strong>http://192.168.31.149/ttc.php/Public/is_identity
	<strong>传递参数：</strong>
		{
			"phpsid":'2fghuuei834849',//phpsessionid
		}
		
	<strong>返回值：</strong>
		{
			"status":1,  //已经实名
			"expand":{"has_goods":1},//1-发布过商品 0-没有发布过商品
			"data":null
		}
		{
			"status":-1,  //-1时有异常
			"expand":{
						"info":"请先登录",
						"type":1  //1-为用户没有登录 2-为用户没有实名
					 },
			"data":null
		}
		{
			"status":0,  //0时有错误
			"msg":"错误码a15"
		}

		如果status非以上3种，前端可报网络错误
	</pre>
</div>

			 
		</TD>
	</TR>
</TABLE>

</BODY>
</HTML>
